home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / mandel / README < prev    next >
Encoding:
Text File  |  1995-05-03  |  2.8 KB  |  64 lines
  1.         README for mandel
  2.                 -----------------
  3.  
  4. Author
  5. ------
  6. Stacey Campbell - formerly staceyc@sco.com, currently ???
  7.  
  8. Overview
  9. --------
  10. Mandel is an X client for exploring the Mandelbrot Set.  It needs
  11. the Motif, X toolkit and X libraries to compile.  It has been
  12. successfully compiled with the SCO X11R4 dev sys, and the OSF/1
  13. Hercules/1 dev sys.  See the Makefile for more details.  It runs
  14. on 16 color and 256 color X servers with PseudoColor colormap
  15. support.  Other colormap sizes will probably work.
  16.  
  17. Commands
  18. --------
  19. Select the area to be investiagated using the standard rubberband
  20. technique of pressing down the mouse button, dragging out the
  21. desired area, then releasing the mouse button.  Mandel saves files
  22. in xwd format.  It does not read in files.  It can read coordinates
  23. from an .Xdefaults file, see the resources in mandel.c.  Here's the
  24. keyboard usage:
  25.  
  26.      'r' - use red colormap
  27.      'g' - use green colormap
  28.      'b' - use blue colormap
  29.      'm' - use mono colormap
  30.      'c' - use colorwheel colormap [default]
  31.      'n' - use default colormap [cannot be rotated]
  32.      's' - use stripe colorwheel colormap
  33.      'a' - use non-green colormap
  34.      'R' - toggle colormap rotation
  35.      '1'..'9' - change colormap rotation speed
  36.      'x' - reverse colormap rotate direction
  37.      'd' - dump current fractal to file "mandel.xwd"
  38.      space - double K value (depth of calculation) [default 128]
  39.      'i' - toggle between generation algorithms
  40.      'q' - quit program
  41.  
  42. Credits
  43. -------
  44. The original program was culled from _The X Window System - Programming
  45. and Applications with Xt_, OSF/Motif Edition, by Douglas Young.  It has
  46. changed somewhat dramatically since then, but its roots are evident.
  47. The original Mandelbrot generation code was derived from the section
  48. "Do It Yourself" in _The Beauty of Fractals_, by H.-O. Peitgen and
  49. P.H. Richter (see image1.c).  My hack to optimize by filling areas of
  50. like color was inspired by John Gossman's article in alt.fractals
  51. concerning Contour Crawling (though it does not use his and Scott
  52. Sherman's code) (see image.c).  I expect their code does much better
  53. optimizations but I couldn't get it working.  The rainbow, red, green,
  54. and blue colormap code and keyboard interface code come straight from
  55. Hiram Clawson's color3 client, part of which was extracted from Foley
  56. and van Dam (see mandel.c).  The window dumping source is a slightly
  57. modified xwd.c from the MIT X11R4 source distribution, originally written
  58. by Tony Della Fera at DEC back in 1985.  The colormap rotation code comes
  59. from Dave Lemke's xrotmap client.  The icon bitmap was created using
  60. Jef Pozkanzer's pbmplus utlities.  Wing Eng helped by answering my Motif
  61. resource questions.  As far as I can tell, all of the above people have
  62. kindly allowed their source to be used in other peoples' code subject,
  63. in places, to the usual restrictions on acknowledgments and sale.
  64.